Content
- Introducing R, RStudio, and Quarto
- Basic set-up and GitHub publication of a Quarto book
- ☕ BREAK
- Text editing in Markdown
- The git workflow
- ☕ BREAK
- Interactivity options (demo)
- Publishing and archiving
Workshop for Education Support colleagues at the UU library
Programming language
Pretty interface to interact with R
(and git, and Quarto)
“An open-source scientific and technical publishing system”
Turn text documents (.qmd) into html, pdf, epub, docx and more.
Today: 💻 html (documents that can be hosted on the web)
Books 📖, but also: slides, blogs, articles, websites, and more.
Quarto = more extensive version of R markdown.
Rmarkdown: make science more reproducible.
Document (.Rmd) containing both R code (R) and text (markdown).
When rendering an R markdown document, all code gets executed as well.
Same for Quarto!
But: more features + more recent than R markdown
💪 Let’s get to work!
Follow the steps here:
https://utrechtuniversity.github.io/open-textbooks/get-started.html
Create a Quarto Book project in RStudio
Render the Book to html
Turn the project folder into a git repository (more later!)
Upload (“push”) the project files to GitHub
Turn on GitHub pages to publish the html files online
For example:
Open the _quarto.yml file and change the title or authors
Change or remove some text from one of the chapters
Remember, to upload a change to GitHub:
git add yourfilewithchanges (select which files to make a snapshot of)git commit -m "Make x change" (create the snapshot with message)git push (upload to GitHub)A Markdown introduction
Bold, headers, bullet points, links
We need to provide the syntax to do this.
We need to tell them how to do this
Explain what git is
Do a round of add-commit-push
Commit
Pull
Pull request
Merge conflicts
H5P
webexercises R package
other options
Archive the repository in Zenodo sandbox
Open textbooks for EduSupport @ UU